Skip to content

site: ammp.ai custom domain; security, licence and changelog pages (DO NOT MERGE until DNS) - #39

Merged
rappdw merged 5 commits into
mainfrom
site/ammp-ai-domain
Oct 27, 2026
Merged

rappdw merged 5 commits into
mainfrom
site/ammp-ai-domain

Conversation

@rappdw

@rappdw rappdw commented Oct 27, 2026

Copy link
Copy Markdown
Member

DO NOT MERGE YET. This PR adds docs/CNAME (ammp.ai). GitHub Pages serves this repository from main /docs, so merging it switches the live site to the custom domain. Merge only once DNS for ammp.ai is in place and the domain switch has been scheduled, and only with the owner's go.

What changes

  • Custom domain. site/CNAME (ammp.ai) is copied into docs/ by site/build_site.py. A missing site/CNAME is a build problem, not a silent drop of the domain.
  • Three new pages, linked from every page's footer:
    • Security: how to report a vulnerability, per repository.
    • Licence: Apache 2.0 for each repository; the Internet-Draft under BCP 78/79 and the IETF Trust Legal Provisions.
    • Changelog: draft-rapp-ammp-00 (an individual Internet-Draft, posted 22 October 2026), the wire contract_version ("2"), and the history before the IETF.
  • Get involved lists the release repository, points security reports at the Security page, and states the wire-version rule the same way the changelog and the draft do.

Checks

  • python3 site/build_site.py --check: 15 pages, docs/ matches site/.
  • Internal link check is clean. Every off-site link was audited against an exact allowlist: 15 pages, 0 unexpected links.
  • Changelog claims were checked against the draft and the frozen contract text.
  • No change to draft/, schemas/, fixtures/ or the frozen spec/ files.

🤖 Generated with Claude Code

rappdw and others added 5 commits October 27, 2026 10:10
- site/CNAME holds the custom domain; build_site.py copies it into docs/
  on every build, because the build wipes docs/ first.
- New pages, linked from the footer: Security and disclosure (per-repository
  reporting contacts), Licence (Apache 2.0 per repository; the
  Internet-Draft under BCP 78/79), Changelog (draft revisions, the wire
  version, the pre-IETF contract history, implementation releases).
- Get involved: lists amap-release, points security reports at the new
  page, and drops the stale "three public repositories" wording.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Changelog: say that the pre-IETF contract numbers (1.0.0 to 3.1.0)
  numbered the document, while the wire value has been contract_version "2"
  since 2.0.0; date the release line and link the releases list.
- Security: give a reporting route for amap-release (manifest) problems, and
  name the address in the "not sure where" sentence.
- build_site.py: a missing site/CNAME is now a build problem, so --check
  fails instead of silently dropping the custom domain.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A wire major bump follows loss of whole-document acceptance, not any
fixture change: contract 3.0.0 moved fixtures and kept contract_version "2".
The page previously said a fixture-breaking change bumps the wire version,
which its own history contradicted.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The page said "breaking a fixture is a major one", which conflated the
document's own SemVer with the wire major. It now states the draft's rule,
matching the changelog: the wire major changes only when whole documents
could no longer be accepted safely.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…cise

- Wire version card and the versioning paragraphs (changelog, Get involved):
  a consumer accepts the wire version it supports and refuses any other
  value, failing closed, rather than "compares majors", which could be read
  as accepting a dotted same-major string.
- "Changes short of that leave it alone", so 3.0.0 no longer reads as
  additive.
- "since contract 2.0.0" for the wire value, and the 2.0.0 entry says the
  wire moved from "1" to "2"; "every document" narrowed, since the binding
  record's contract_version is optional.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@rappdw
rappdw marked this pull request as ready for review October 27, 2026 20:41
@rappdw
rappdw merged commit 376c338 into main Oct 27, 2026
1 check passed
@rappdw
rappdw deleted the site/ammp-ai-domain branch October 27, 2026 20:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant